Skip to content

chore: replace astro-icon with nimbus-docs Icon, bump nimbus-docs to 0.10.0 - #32647

Merged
mvvmm merged 9 commits into
productionfrom
chore/nimbus-icon-replacement
Aug 11, 2026
Merged

chore: replace astro-icon with nimbus-docs Icon, bump nimbus-docs to 0.10.0#32647
mvvmm merged 9 commits into
productionfrom
chore/nimbus-icon-replacement

Conversation

@mvvmm

@mvvmm mvvmm commented Aug 10, 2026

Copy link
Copy Markdown
Contributor

What

Replaces astro-icon with the built-in icon system from cloudflare/nimbus#76, and bumps @cloudflare/nimbus-docs to the published 0.10.0 release.

Changes

  • Removed astro-icon from package.json, astro.config.ts, and all 53 component/page files
  • Replaced all importsimport { Icon } from "astro-icon/components"import Icon from "@cloudflare/nimbus-docs/components/Icon.astro"
  • Collapsed AstroIcon aliasIcon and AstroIcon were the same component; merged all usage to Icon
  • Updated virtual modulevirtual:astro-iconvirtual:nimbus/icons in directory.astro
  • Removed @ts-expect-error — the nimbus integration injects types for virtual:nimbus/icons
  • Bumped @cloudflare/nimbus-docs to published 0.10.0 (was pkg.pr.new preview pin)
  • Bumped astro to ^7.2.0 to satisfy the 0.10.0 peer range (>=7.0.0 <7.1.0 || >=7.2.0 <8.0.0)

Why

astro-icon stamps a lastModified timestamp into its virtual module on every build, invalidating Astro's incremental build cache for thousands of pages. The package hasn't had a commit in 2+ years. Nimbus 0.10.0 replaces it with a built-in Vite plugin that omits lastModified, making the cache stable.

The nimbus release also includes a workaround for the css-tree createRequire bug (svgo#2149) that breaks Vite prerendering — it redirects css-tree and csso to their browser bundles which have JSON data inlined.

Astro 7.1.x was excluded from Nimbus 0.10.0's peer range due to an upstream static build regression; 7.2.0 fixes that regression.

Verification

  • pnpm run check — 0 errors, 0 warnings, 0 hints
  • pnpm run lint — clean
  • pnpm run format:core:check — clean

Tests the astro-icon replacement PR in cloudflare/nimbus#76.
Uses pkg.pr.new preview build from commit acfac20.
@mvvmm
mvvmm requested review from a team as code owners August 10, 2026 20:21
@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Aug 10, 2026

Copy link
Copy Markdown
Contributor

Review

✅ No issues found in commit 9e04bcc.

Code Review

This code review is in beta and may not always be helpful — use your judgment.

No code review issues found.

Conventions

No convention issues found.

Style Guide Review

No style-guide issues found.

Commands

Only codeowners can run commands. Post a comment with the command to trigger it.

Command Description
/review Runs a review now. Incremental if a prior review exists, full if not.
/full-review Re-reviews the entire PR diff from scratch, ignoring incremental history. Useful after a rebase, when you want a fresh review, or if the bot gets out of sync and reports issues that no longer exist.
/ignore-review-limit Permanently lifts the 2-review automatic limit for this PR. Future pushes will trigger reviews as normal.
/disable-auto-review Stops automatic reviews from triggering on future pushes to this PR. Codeowners can still run /review or /full-review manually.
/rebase Rebases the PR branch against production. On conflict, attempts to resolve automatically using AI. Stops with an explanation if confidence is not high enough.

@github-actions

github-actions Bot commented Aug 10, 2026

Copy link
Copy Markdown
Contributor

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
*.ts @cloudflare/content-engineering, @kodster28
package.json @cloudflare/content-engineering
* @cloudflare/product-owners
*.astro @cloudflare/content-engineering, @kodster28
/src/components/agent-setup @cloudflare/product-owners, @cloudflare/ai-agents, @cloudflare/dev-plat-leads
/src/components/models/ @mchenco, @superhighfives, @ethulia, @kflansburg, @cloudflare/content-engineering, @cloudflare/product-owners, @kodster28
/src/content/docs/browser-run/ @mchenco, @cloudflare/product-owners, @celso, @kathayl, @meddulla, @simonabadoiu, @jonnyparris, @ruifigueira, @Refaerds, @omarmosid
/src/content/docs/style-guide/ @cloudflare/product-owners
/src/pages/agent-setup @cloudflare/product-owners, @cloudflare/ai-agents, @cloudflare/dev-plat-leads

@mvvmm
mvvmm marked this pull request as draft August 10, 2026 20:30
@mvvmm mvvmm changed the title chore: test nimbus-docs PR #76 (astro-icon replacement) chore: replace astro-icon with nimbus-docs Icon component Aug 10, 2026
@mvvmm
mvvmm force-pushed the chore/nimbus-icon-replacement branch from 94e2d42 to ae599f2 Compare August 10, 2026 20:37
- Replace all astro-icon imports with @cloudflare/nimbus-docs/components/Icon.astro
- Collapse AstroIcon alias to Icon (they were the same component)
- Update virtual:astro-icon to virtual:nimbus/icons in directory.astro
- Remove astro-icon from astro.config.ts and package.json
- Point @cloudflare/nimbus-docs at PR #76 preview build
@mvvmm
mvvmm force-pushed the chore/nimbus-icon-replacement branch from ae599f2 to 7850a5d Compare August 10, 2026 20:44
@mvvmm mvvmm changed the title chore: replace astro-icon with nimbus-docs Icon component chore: replace astro-icon with nimbus-docs Icon, bump nimbus-docs to 0.10.0 Aug 11, 2026
@mvvmm
mvvmm merged commit 84da42b into production Aug 11, 2026
17 checks passed
@mvvmm
mvvmm deleted the chore/nimbus-icon-replacement branch August 11, 2026 21:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants